perm filename TOSCIP.DOC[S,DOC] blob sn#444467 filedate 1979-05-31 generic text, type T, neo UTF8
TOSCIP is a program which may be used to read and write tapes in IBM-
compatible format.  Commands exist for setting tape parameters, displaying
the currently selected parameters, moving to a specific file on the tape,
reading, and writing.  Some of the more important commands include:

DISPLAY         show the currently selected parameters.  When reading a tape,
            be sure that these match the parameters that were specified when
            the tape was written.  When writing, be sure to record these
            parameters for future reference.
READ filename   read the next tape file into the disk file named "filename".
WRITE filename  write the disk file named "filename" to tape.  You can
            specify several filenames separated by commas.
SCIP default    select a prepackaged default format compatible with utilities
            at SCIP.  Currently, you may choose:
    CARD  ---   suitable for card-image data sets and most general portability.
                DCB=(RECFM=FB,LRECL=80,BLKSIZE=8000,DEN=3,OPTCD=Q), upper-case
                translation on write, delete columns 73-80 on read.
    PRINT ---   suitable for text files to be printed on an IBM printer.
                DCB=(RECFM=FB,LRECL=133,BLKSIZE=7980,DEN=3,OPTCD=Q)

For a list of commands, type "?".  For information a particular command,
give the command HELP followed by the name of the command, e.g.:

	TOSCIP>help recfm

The following is a complete list of commands, and their descriptions:

ASCII
     Sets TOSCIP to read and write without translation until an
     EBCDIC command is seen.  This assumes that the files will contain
     ASCII text.

BLKSIZE decimal number
     Sets the tape blocksize to be used for subsequent reads and
     writes.  This should be an integral multiple of the desired
     Logical RECord Length.

DENSITY  800 or 1600 or 2 or 3
     Sets the density to be used for subsequent reads and writes.
     You may use 800 or 1600 bpi, or the IBM equivalents 2 and 3
     respectively.  It is not advisable to change densities in the
     middle of the tape.  LOTS will not mind as long as you are
     consistent however you will not be able to read your tape on
     an IBM system.

DISPLAY
     Display the DCB from the IBM JCL which corresponds to the current
     settings of various parameters.  This is (almost) the DCB which
     should be used to read a tape written here, and it should be the
     same as the DCB which was used to write a tape which is being read
     here.  Note that the blocksize must be an integral multiple of
     the logical record length.  However, the format command does not
     check this.  When you actually read or write a file the
     blocksize will be forced to an integral number of records so
     a FORMAT command which is given after a WRITE will indicate
     the format that was actually used.

EBCDIC
     Sets TOSCIP to translate to EBCDIC on output and from EBCDIC
     on input.  Files which contain control characters, other than
     tabs, carriage returns, and line feeds may get changed in the
     process as not all characters have an equivalent.

EOT
     Advance to the end of tape.  This command is useful if you wish
     to add files to the end of an existing tape.

HELP command-name
        Types information on various commands.

LRECL number
     Sets the logical record length to be used in subsequent reads
     and writes.  this may be any value between 1 and 256.  If you
     need to write a larger size record see a member of the LOTS
     staff as there is a minor modification which can be made to the
     program which will allow this.

NO RAISE
     Sets TOSCIP so that lower case is not converted to upper case
     on output.  Lower case is NEVER converted to upper case on
     input as most programs at LOTS handle upper and lower case
     as equivalent.
NO ASCII
     Equivalent to EBCDIC.
NO EBCDIC
     Equivalent to ASCII.

OMIT column-number
     On READing from tape, throw away any characters on a record at or
     after this column.  The default is "omit 73" which omits the sequence
     number columns on card images.

PAUSE
     Temporarily exits from the program.  The tape drive will still
     be assigned to you.  You may use any EXEC commands you wish.
     If you run another program (without PUSHing) you will have to
     get TOSCIP again but this is not fatal.  To continue type
     CONTINUE, or START, or TOSCIP to the "@" prompt.

QUIT
     Exit from TOSCIP.  This unloads the tape and deassigns the tape
     drive.

RAISE
     Sets TOSCIP to convert lower  case to upper case on output.  Upper
     case is NOT converted to  lower case on input.  It is important to
     use  this command if you  are transferring program text  to an IBM
     system,  since no IBM  compiler will accept lower  case input.  If
     you  are transferring text, such  as a term paper,  then you would
     probably  want  to  use  NO RAISE  instead,  to  insure  that  the
     conversion did NOT take place.

READ output file name
     Reads one or more files from the tape, using the current format
     settings, in to the designated file.  If the BLOCKSIZE is not
     an integral multiple of the record length it is rounded toward
     the record length.  That is if it is less than the record length
     it is rounded up, otherwise it is rounded down.  The tape is
     left after the file which is read.  If several file names are
     specified (separated by commas), then that many files will be
     read from the tape.

RECFM fb or fba
     select the record-format "format".  On reading from tape, choose the
     format in which the file was written.  On writing, choose (normally)
     one of the following:
        FB      "fixed block", for card images, etc.
        FBA     FB, but tape file contains carriage control characters
                in col. 1 of each record.
     If you specify FBA, then the first character of each logical
     record on the tape will be presumed to contain Fortran-style
     carriage control characters.  Carriage returns, CRLFs, and
     form feeds will be converted to or from carriage control
     characters as appropriate. 
 
REWIND
     Rewinds the tape to load point (beginning).

SCIP print or card
     Sets the format to be compatable with the public execfiles
     #fromlots and #tolots at SCIP.  The options are:
  CARD    Best for source programs, data, and SPSS input cards.
        Translates lower case into upper case with record length=80.
        Not good for files that might have lines  longer than 80
        characters.  This format is more efficient than PRINT if all
        the lines will fit in 80 characters.
  PRINT   Best for text files to be printed at SCIP.  Inserts carriage
        control characters at the beginning of each line, translating
        page marks to "1" in column 1.  Does not translate lower case
        to  upper case; record length=133.  Wasteful of space if all
        the lines are less than 80 characters long.
  TEXT    Best for text files to be stored on disk or further edited
        using Wylbur.  Does not translate lower case to upper case;
        record length=133.  Wasteful of space if all the lines are less
        than 80 characters long.
    Any or all of the characteristics of the SCIP formats can be changed
    after the SCIP command has been given.  The only parameter that it
    is advised you change is the RAISE/NO RAISE (e.g. if you wanted
    lower case with the CARD format).    

SKIP  decimal integer
     Skips the specified number of files forward.  A negative
     number skips backwards.  SKIP 0 is a nop.

WRITE input filespec {,optionally addtional files⎇
     Writes a file, or group of files to the tape using the current
     format settings.  As each file is written the user is notified
     of the progress of the transfer.  Each filespec may contain
     wildcards, and may hence imply writing of several files.